APPENDIX 



Menu Commands 



Viva 1.0 ■ 



Tne Menu Commands of V,VAa«.ow you to display, enter. edMnd save V.VA programs. 
PijeMenu Load and display VIVA projects 
FditMe r,u Graphical editing, cutting and pasting 

Vifiw Menu View Options 

SystemMenu Target system selection and control 

HeirjMenu Assistance to the user. 
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File Menu 




New Project B 
O pen Project ! 
Save Project 1 

Save Pro ject As 1 
New Sheet 1 
Du plicate Sheet 1 
O pen Sheet 
Save Sheet As I 
Convert Sheet to Object I 
Delete Sheet 1 



Plav/Stop_ t& 
Print 

Print Setup 



Clears all objects, pages, and Modules. 
Loads and displays a VIVA project. 
Saves the current project. 

Saves the current project with the name you specify. 
Creates a new sheet or Behavior Page. 

Saves and renames the current project. 

Loads a sheet from a file. 

Saves the current sheet with the name you specify. 

Captures sheet behavior as a VIVA Module. 

Erases and deletes the current Behavior Page. 

Executes the behavior on the displayed Behavior Page. 

Prints the current sheet. 

Sets up the printer options you speafy. 
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Exit 



Quits VIVA. 
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Clears the 
conditions 



current Project and Behavior Pages. This function is equivalent to a reset of VIVA to the initial 



WARNING 

Be sure to save your work to a file before selecting this function. The New Project function deletes all 
work. All work may be lost. 
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Save Project Command ^ 



v- Viva 1.0 



^jSav e Project f 



gsssssas ^sr»»^««e — * used. «« . ^ 



has been saved, it can be retrieved using Open Project I 
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Save Project As Command 




This saves an entire project with the new name you provide. As with Save Project, this procedure saves 
^M^^Pb^). all of the data sets, the U. Form, and everything else assoaated w,th a 



project. After a project has been saved, it can be retrieved using Open Project 
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Use this command to create a new Behavior Page . The old Behavior Page is not lost, 
reactivated by clicking on it in the Rghavior Page Tree. 
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Use this command to duplicate the current Behavior Page . 
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Open Sheet Command 




This loads a Behavior Page from a file. 
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Save Sheet As Command! 

This saves a Behavior Page to a file with the name you specify. Because there is no Jimit to the number 
of VIVA Modules you can place on a Behavior Page, this feature enables you to create Ubranesof VIVA 
Modules. 






i^|Sc^e Sheet As :;A^;.;:.:'F7; 




| Save As '?V: •: V."--"' 






12 Il| 






if!! 

tf mm :mm\ 
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Convert Sheet To Object Command iH 

Once you have defined a Behavior Page for a VIVA Module, you can then convert the Behavior Page into 
a VIVA Module. Inputs and outputs of the Module are the same order and type as defined for ^the 
Behavior Page: Before saving the Module, you are given a final chance to enter the 'nformabon about 
the Module (things like giving the Module a name, naming the input and output "^"g^S*? 8 
the function of the Module and how it is intended to be used . This « done through me Come J Sheet 
Dialog Box. To maintain universality, this interface is essentially the same as the F<M Attributes D.aloq 
Box. 




Notes: 

1 . This dialog is probably the best interface provided for naming Module nodes. We recommend you 
name Module nodes here. 

2. Documentation should be provided at this point, to define the function of the Module, its intended 
uses, and restrictions in its use. 

3 Overloading is a characteristic that allows you to write several versions of the same behavior to 
handle the various implementation requirements. As a result, you can have three or four d fferent 
addition Modules. In many of these cases, you will use a prior implementation as a template for the new 
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behavior. In these instances, you have the option of either updating the existing Module or creating a 
new one. 

4 You also have the option of selecting for the Module the appropriate Tree Group in the Object Tree . 
Typical Tree Groups include Bit Operations. Arithmetic Operations, Test Modules, and so forth. 
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Delete Sheet Command 



v Viva 1.0 • 



g^C>e!ete Sheet v . : - 



This command closes the current* displayed sheet. Any information on the sheet is lost. 
You will receive a warning screen to verify that you really do want to delete the sheet 
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Run Behavior Page 



When you click on the Play/Stop 
Ftehavior Page. 



button, VIVA will execute the Program specified by the current visible 



■t' Viva 1.0 



filiiHStlii 




Inputs and Outputs to the process 
Behavior Page. 



will be the Inputs and Outputs specified on the currently visible 



RESTRICTIONS 



To exec* a WA program, none o, the lapu* on me cur^ visible Bebav* Page caa be of *pe 

Variant Otherwise, an error will occur 
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Edit Menu 





can be done in a number of ways: 

1 Toseledasingleobjectdic^onitwiththemouse. 

objects. 

Groups of objects can be copied between different Behavior Pages. 

Note 
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View Menu 




"""""" BiSKlliiiSl 



rikniaved level of detail. Many of these commands are available 



View Details 

View Object Names 
\/.p\A/ Node Names 
View Nodes 

Sort bv Tre A firoup/Name 
p^grAnri into Sheet 



S Displays the object name above each object. 

H Displays each node name instead of each node's icon. 

H Displays node colors on Iranseorte. (Node colors correspond to 
data types). 

Gl Sorts the Object Tree in alphabetical order. 

H This displays the Behavior Page of the seteoted^ject (This 
Sire is also available by double^icking on the object) 
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View Node Names — 

NaiUs are displayed, the loons are suppressed. 

T.e.o.^^lcsdlspUyaBe.a^Page^and^oa.meNodeN^sd^. 




107 



f 



View Nodes HI 

Node types become evident by their color if the View Node mode is activated. 
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Descend Into Sheet 

after the Module has been selected using a left mouse click. 



by clicking on the descend icon 

The following is the Behavior Page for an Exclusive OR Module 



^^^^ _ ^ 




no 



System Menu 




^tethidisplay and entry of data tnausp 



in 



Open System 



-•Viva 1.0 




Selecungthetargetsystem. At^of—o" iCStSSS?^ 
Floating Point Gate Array (BaseXPoint) ««erfaceand lh ! X86I Jser Infcnwa k> ^ t 

software without requiring that an FPGA board be present. 
No,* Justt^se^BaseXP*,^^^ 

an computing functions will be allotted «. G^Ware™. J£«^< SrSation of physical allocation of 
on the Usef s computer. External devKes are altocated «*25^ Th. Search Engine selects from 
SSS^SSS^^l^^ « «. quired In— Rate. 
^n^MeWare To force any particular VIVA Module into GateWare. se, the System «tdbu.e Suing 
of the Module to contain the desired system. 
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NEW Ul Form 
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Help Menu 
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ToolBar Controls 

The Graphical User Interface of VIVA was 
target computer environment. 



designed to allow you to spedfy the desired behavior of the 




Run/Stop 
View Details 

PIP ypxA/ nhj ent Names 
pi v/j^w Node Names 

IB View Nodes 



Clears all objects, pages, and Modules. 

Load and display a VIVA project 

Saves the current project 

Saves and renames the current project projects. 

Creates a new blank sheet. 

Duplicates the current sheet. 

Loads a sheet from a file. 

Saves current sheet as a file. 

Captures sheet behavior as a VIVA Module. 

Erases and deletes current Behavior Page. 

Executes the behavior on the displayed Behavior Page. 



The names 



of the objects are displayed above the objects. 



The names 
object's icon 



The node colors are 
to data types.) 



of the nodes of the objects are displayed instead of the 



displayed on Tjansports. (Node colors correspond 



h y Trpfi Grouo/Name Sorts the Object Tree in alphabetical order. 

DiS p.ay the Behavior Page of the selected object (Also available by 



I Sort 

I np.scend into Sheet 
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double-clicking on the object.) 




Selects the target system. 

Displays the User Interface Form. 

Allows you to Select a new User Interface Form. 
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DataSet Editor 

OataSet Editor is acthrated by pressing the DataSet Editor tab at the bottom o! the mair. «ndo«. 




WA-menpreseht^DataSetEdi^lbe^ £^%»&Z^££Z2Z 

in the left pane. 

gSS3s33sS3SS ass 
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^t-q— : gas 

^^^^^ 




When done with defining the new data set. you press the Save Button 



NntA- Most of the existinq software is geared toward processing DataSets with two components^ 
XEJ^ wSta^^ sometimes unusual results occur. Limiting the number of DataSet 

^mp?ne!IS toC^noSly a restriction, because component parts can always be comb,ned pa.r w,se 
to make up any composite DataSet. 



119 



Edit Attributes Dialog 




^ EditAttnbufes ^ 
include giving B,e Module a name. nam,n| to ^"^f"^,^ ^ of,* on the Module to be 
the Module and how it is «»^* J!, SS same as the -~—f obiecl 

Notes: 

from the Object Tree . 
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Constructing VIVA Modules 

A VIVA Object or Module consists of a graphical device with an associated l^^^,^^ t0 
^rand/oToutputs. When represented graphically, the input nodes are located on the left, and the 
output nodes on the right. For example, consider the following Add module: 




Thk module has three inputs and two outputs. The inputs consist of two operands and an optional carry 
T^t^cSSSffL sum and a^cany bit The cany bit is important for spec.fy.ng the recurve 
definition of addition, and is useful in many applications. 

To use the addition module, place it on a Behavior Page and connect it to input and <**P^^ *™* or 
Snsr^rte The following example accepts two inputs, adds them together, and dtsplays the results. 




To create this example first load a library or Sheet containing the addition module using the Open Sheet 



command I 
list of available modules. 

To test addition the types of the inputs must be changed from the default type of bit to something such 
Is Inf- "°'"H ** *** Attributes Dialog . After the correct DataSets have been speeded for the 
fnpute^S inp ute and outputs to the add module, and press the Run/Stop Button from the 

ToolBar 
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Behavior Pages 



object with a left mouse click then click on the descend icon 



I on the ToolBar. 



You execute a Behavior Page by clicking on the Run/Stop, button I 
Definition of VIVA Modules begins with Inputs 

K anSppSt!! onto the Behavior Page, using Drag and Drop. 

lfMA rinht pi flrp the InDuts on the left side of the page and 
Information flow should be designed from left to right. Place the inpuis 

the Outputs on the right 
AND (or NAND) Module: 




path. 

junctions are used when it is necessary to split a signal. 

Once the beha*ris denned, you than ^H************^*** me 

,-„„„„, Steet to Object command horn the File Menu, or select the ToolBar icon. 

THesys.en.-t^eateanew^^^^ 

NAND Module will have one input node and one output noae ^cone^ 
Output) and appear as follows: 



HAND 



This Module may now be used to construct 
behavior. 



other behavior pages for Modules with more complex 
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Node labels for the inputs and outputs of the HAND Module are the same labels on the inputs and 

outputs of the Behavior Page. 
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Connecting Transports 

can click the mouse at various points along the desired path. 



r Viva 1.0 



mmm\ 




Notes: To facilitate the con-ect specification of data types, the foUowtig conventions or mfes have been 

established: 

type. 

2 If a Transport is drawn to an Input or Output with type Bit. this will effect a change of the Input or 
OutputtoStaSet to match that of the node to which the transport » connected. 

3 If a Transport is drawn to an arbUrary node of type Variant, this will effect a change of the Node 
DataSet to match that of the node to which the transport .s connected. 

4. Nc^esareeither^ 

5 VIVA will not allow you to connect two nodes with incompatible type. 

the Object Tree . 
Hints: 

1. Node types become evident by their color if theShow Node Type View Node Type Mode is 
activated. Do this by clicking on the ToolBar icon Si. 

2. A typic*.waytoforc«adataty^ Forexample. 



124 



DataSet of the input to be of type Word. 
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Connecting Junctions 

junctions are used when the same signal needs go to more than one Create a Junction by 
either double clicking on a transport, or by selecting a Juncton from the Ob|ectTree . 
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Convert Sheet To Object Command 



ooce »» Have de*ed a BsM^ ^T^K^^ - ^ 
a WAModute. Inputs and outputs of the Mod*. "» to ^ r „, Wonnation about 

Box. 




name Module nodes here. 

2 ooo.— sh o uMt e^ada tt K fe po 1 nUode fi „e^ fUn *no,« h eMod Ute .«s mt e^ 

uses and restrictions in its use. 

3 Ovenoadingisac^e^^ 

L£ t various Jnp*"«^ a template for the new 

addition Modules. In many of these cases, you wmub w 
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Object Trees 

AND. OR. Invert), n a t a R»t Fxoosers/Collectors,. 




dragging it to the appropriate position on the Behav,or Page. 



Notes: 



1 . New Tree Groups can be created with a right mouse 



click in the Object Tree Window. 
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2 ^nt.m^**^^^*"*'*** 1 "*'''"'***''"*' 

item, and selecting a different tree. 

W^^c fe a,e»^ m o,u te .^= re8 ^.09^^o n eCo m pos«eOb i Mnmeo m . 

different OataSets .^"SiSU arithmetic to signed integer is a different 
ComposKeOt^nsstoft^oi™^ 

Modules, they are groups I togethe. jn to ^<? m P™L e s«3£«me behavtor. The composite object- 

•^r^a^=«^^^ 

Module is always of type Bit 

^^^^^^^-^-^ 

Add Object. 




polymorphic module will handle them, 
r^.-creatingagene^pd^ 
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Constructing Polymorphic Objects 



Resolution. 



^SSSTt^cL. Bits are discarded and a different tehav.oraempkved. 
^ha^vanl^fawncations^out having to change the Behaw* Page. 



Recursion 



SCSK 5&Tpa»&=« m a *e need * speed. 
SSaSns. Additionally, two different definitions can be specified for the same object. 
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Modifying an Input 




enter values in the Attrih.ites Dialog 
Data provided to the Input is provided from an 



external interface. The data will be obtained from the node 



column. The default name is In1. 



at the higher-level connection, or from a Widget. 
To label an input, enter the appropriate name under the name 
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Modifying an Output 





uuliinu "Inn in 'fy f rf » P 13 ' 00 - 

T^e output data .on, the Mod*, - be sen. to etthe, a W^evet connect * a W M3 ot 

Box The default name is Out1. 
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VIVA Constants 

ftecapaMllyl<>aMi9"» alues,onodes "* ichare "° tl ' P ' 
u Ssr then enters Constant 1 in the attributes sechon of the dtalog box. 




constant value. 

,n the following example, the behavior page for a moduie. Ind increments by 1. but the constant does 
not become an input node. 
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VIVA DataSets 

The fundamental DataSet is the ^^^^''^^^^^^^^biteorm^^^rn^^^^^-*^^^ r 
S wa ateo supports the following fundamental DataSets. 



Definition /rone™- 
The atomic DataSet. consisting of a piece of information with two states (TRUE or 
FALSE, 0 or 1, etc.) 

Double Bit. 2-BK Cardinal DataSet PairofBits. HalfaNibble. Needed tomake 
higher-level aggregate DataSets. ^rwa^ 
4-Bit Cardinal DataSet. Ha.faByte. Needed to make higher level aggregate DataSets. 

8-Bit Cardinal DataSet Two Nibbles. 
16-Bit Cardinal DataSet Two Bytes. 
Double Word. 32-Bit Cardinal DataSet Two Words. 
Quad Word. 64-Bit Cardinal DataSet. Four Words. 

16-Bit Signed Integer. 
32-Bit Signed Integer. 

64-Bit Signed Integer. . 
The data type does not get elaborated until execution, at which time it is resolved ,nto a 
known DataSet. 

AbuiINn feature ofVlVAisthe automatic for— ^Jf^Kgg^^ 
Module breaks up a date set into <ts comPOS.n| ^ for ^e • * J" g ^ ^ 
Bytes. A Collector combines two parts to make a larger uawoc 
combines two Bytes to make a Word. 

The Variant DataSet is used .o representor ;^~^ D *^Sn^S^ 
featureenabteWAtoformulategene^^ The 

input data sets become known. 



DataSet 

Bit 

DBit 

Nibble 
Byte 
Word 
DWord 
QWord 

Int 

Dint 

Qlnt 

Variant 
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DataSet Exposers and Collectors 



c«r a n U viva DataSet the Exposer and Collector are automatically defined as part of the language An 

Wes. The WordOu. Collector takes Mo B*es and puts them together 

to make a word. 



DataSet 


Exposer 


Collector 


x Bit (Note 1) 






V DBit 


DBitln 


DBitOut 


* Nibble 


Nibbleln 


NibbleOut 


% Byte 


Byteln 


ByteOut 


^Word 


Wordln 


WordOut 


J DWord 


DWordln 


DWordOut 


v^QWord 


QWordln 


QWordOut 


Int 


Intln 


IntOut 


Dint 


Dlntln 


DlntOut 


Qlnt 


Qlntln 


QlntOut 


Variant (Note 2) 


Variantln 


VariantOut 



Note 1: The Bit is the fundamental data set. and has neither a collector nor an exposer. Any attempt to 
break up a Bit into its composing parts will result in an error. 

become known. 

WARNING 

,„ some cases. DataSet Collects ma, no. be unjue. F or exajjge ^« *t S^Ss 

using the generic system Cast Operator. 
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Forcing GateWare Allocation 

To force any particular VIVA Module into a particular system, set the System Attribute String of the 
Module to contain the desired system: 

1. Right click on the Module. This brings up the Fdit Attributes Dialog Box. 

2. Under the left attributes column, enter the text. ChildAttribute 

3. Under the right attributes column enter the text, System^Polnt". (See panel below.) 

4. Press the OK button. 
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List PopUps 

ASIC 
Clock 

Data-flow machine 

Event 

Go 

Module 
Persistence 
Reset 
VIVA 



Behavior 

Collector 

DBit 

Exposer 

GUI 

Object 

Polymorphism 

Resolution 

Wait 



Byte 

Composite Object 

Done 

FPGA 

Integer 

Overloading 

Ready 

Sync 

Wire list 



Cardinal 

CPU 

Drill 

GateWare 

Library 

Parallel 

Recursion 

Variant 



\ 
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ASIC . 
Application-specific integrated circuit 

inputs, add them together, and send the result to the output 

Aggregate data type consisting of « bits. B»te a*metio is considered to be unsigned integer. 

SI ln.erpre.ato, where a stdng o, bits is interpreted as an unseed integer. B* Won.. OWord. 
and Huge are all Cardinal number types. 

?h?VIVA event that is clock driven, usually at regularly timed intervals. 
AModSthat assembles a collection of DataSets into a Composite DataSet. 
A^ro^mposed of inputs, outputs, and more primitive Objects connected by Transports. 
Central processing unit for a serial computer, usually a microprocessor. 

S^^^daUHlriwen architecture has instructions available for concurrent execution rather than 
sequential execution. 

jfelbleBiL 2-Bit Cardinal DataSet. A pair of Bits. Half a Nibble. 
DBitln 

The DataSet Exposer Module of DBit. 

DBitOut ir ^. t 
The DataSet Collector Module of DBit 

The VIVA event that indicates that the Module has been executed. 

To highlight and to expose additional information about the Module. 

X a change of state that occurs in time. Examples include ready, wait. go. and done. 

AWA Module that separates a Composite Object into its component parts. 
FPGA 

Field programmable gate array. 

GateWare GateWare™ is a trademark of Star Bridge Systems. Inc. 

A VIVA implementation created through VIVA, tiateware is una 
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Go .. 
The VIVA event that signals another Module to begin execution. 

GUI 

Graphical user interface. 

A nt numenc interpretation of a string of bits in wnich the highest b* is interpreted as a sign bit. Negative 
values are represented as 2's complement. 

A Son of software Objects or Modules that can be accessed by a user and incorporated into a 
project. VIVA implements Libraries as sheets of objects. 

Apical device with an associated behavior when connected to inputs and/or outputs. Also called 

Object 

A graphical device with an associated behavior when connected to inputs and/or outputs. For precision, 
we prefer to use the term Module in VIVA. 

Additionally, two different definitions can be specified for the same object. 
Parallel 

The simultaneous execution of multiple circuits rather than a single path. 

Th^biHtyto save VIVA object code (GateWare) on storage media such as a hard disk. 

tS^VIVA Module to support data types with arbitrary precision using the same object or 
function. 

DataSet Polymorphism refers to VIVA's ability to instantiate the appropriate GateWare 
depending upon the data type of a variant object's inputs. 

Information Rate Polymorphism refers to VIVA's ability to instantiate the appropriate GateWare 
depending upon the need for speed. 

The VIVA event that notifies another Module that it is ready to receive data. 
Recursion 

The ability of a function to call itself. 
Reset 

The VIVA event that signals a Module to reset. 

SSs of determining the meaning of an abstract concept for a particular application. v 



141 



Sync 

The VIVA event that synchronizes the start of execution of two or more processes. 
Variant 

An attribute that could have multiple meanings, depending on the application. 
VIVA 

The operating system, language, and user interface created by Kent L. Gilson. VIVA™ is a trademark of 
Star Bridge Systems, Inc. 

Wait 

The VIVA event that signals another Module that it is not ready to receive data. 
Wire list 

The topology of a circuit showing the devices and their connections. On an FPGA. it shows the state of 
each gate and the connections between them. 
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